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PARC MEMORANDUM 



TO: ALTO LAND and In particular, possessors of JK CONTROL RM1S 

FROM: David Boggs 

SUBJECT: Usinq the Control Ram 

DATE: April 17. 1974 

This memo Is e description of a progrom called RAMLOAD, which runs under the ALTO 
operating system, and docs Just what It soys, as well as a few other useful things 
which v/ere easy once It was possible to load the ram. RAMLOAD was written to 
facilitate debugging EARSCODE - Ethernet Alto Research character generator Slot 
microCODE, which will not all fit in the 512 word debugger ram. With this program, 
tasks with working microcode can be run In the IK control ram, freeing the entire 612 
words of debugger ram for the task whose microcode Is being debugged. 

Since there are now two types of ram for the ALTO, some distinction must be made. 
Hercafer. ROM means some combination of roms on the ALTO control board, and add-on 
goodies which hang on end of the control board like debuggers with 612 words of ram. 
RAM means the extra board with IK of ram which plugs Into a slot In the processor. 

BM1LOAO gets Its parameters from the command lino and default values. If you do not 
specify a parameter, the default Is used. In addition there, are some global switches 
which do other useful things as oxplQlned below: 



GLOBAL SWITCHES (of the form RAMLOAD/swilchllst) 

/R compnrp the micro binary file against the contents of the 

RAM and display differences. 
/V compare the micro binary file against the contents of the 

ROM and display differences. ' 

■/C compare the micro binary file against the contents of the 

constant memory and display differences. 

LOCAL SWITCHES (of the form bla/swUch) 

/F use bin as the nnme of the micro binary file. Default is 

"BlNf^lLE." 
/IW use b'a as the name of the instruction memory In the micro 

binary file. Default Is "ifJGTRUCllON". 
/C use bla as the name of the constant memory In the micro binary 

file. Default is "CONSTANT". 
/V bla is an octal number. Use It as the boot locus vector. Bit 

15 corresponds to task (omulntor). means run task In the 

RAM. Default Is *177777 - keep all tasks in ROM. 
/A bla is an octal number, representing the base address of a 

6 word area In the RAM which RAMLOAD can use for utility 

purposes. Default Is the top 6 words (*1773). See warnings 

below about restrictions for specific operations. 
/S bla is an octal number interpreted as the beginning address of 

the emulator main loop (START for microcode hackers). Oofautt 

is the current START address, 4f336. 
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Nulp Hint (iIoI).tI .swItnhr'S /V and /C do the same tiiinos that ;V and :C do in CESAL. 
HAnUOAl) III rffoct (Inrs a -.L. and also sots the boot locus vector. Tbp /H global 
swili:l> wds n(l(l<>(| hpcniisr it wns nnsy nnd people miaht wont to see If t^ie microcodo 
f|n( s'in/isli(>(l nftjjr n fi,nsno. 

Whrn nAMIOAD l.s rnlird. It will first display what It thjnks. IL^.I^ .SUPPc^rd to do «5 
riovcrriUMi by the ,<;wilchi's nnd dclaulls, nnd wait for a confirming corrinqc return. 
Onco this Is rcceivr.'d. If any gloli.-il switches were sot. It will do the appropr-ate test, 
rnpnrt the rcsiiit.s. niul then wail for a confirmation that It should lo.id. If no global 
switches wer«> set, It will nssunic you wanted to lond, and do It. Loading first sets thfl 
boot locus vector, nnd then loads the RAM so that you can load even the 5 word utility 
nr«>n. When complete It will report the number of Instructions loaded, and the highest 
ndclress <nln DEHAL. Next the program will ask If you want to boot (thus moving the 
tn.«;k.s spfM;lfIpcl In thn boot locus vector into the newly loaded microcode In the RAfW). 
If you confirm, nnd If you have an ETHERNET board, the machine will do a software 
Inltlntnd boot. If you do not have an ETHERNET the boot will be a NOP, and a FINISH 
Is executed. Hitting the boot button after the program Is finished will work for those 
hermits who do not have ETHERNETS. 

Tho routino which reads the micro binary file expects the limited subset of block-types, 
thnt DLBAl puts out. If It encounters an unusual block-type (3, 5, or C) . It Will 
cncionvor to do tho right thing, and continue on. When It Is finished reading. If any 
iintisuni typos were encountered, it will list how many of each It read. If the micrccojJft 
was assembled using DEQAL, this Is cause for grave doubts about the correctness of 
thn flip, since DLBAL will not currently generate those types. 

Where tho b word utility area Is specified can have profound (le. potenMafly 
(lisasterou.s) effects on the mnchino's operation If you are currently running front the 
RAM. While it Is possible to load Into the microcode you are currently executing for4n. 
this Is living very dangerously. However, If you must, observe the following caveflts: " 

* If constant memory Is being checked, and you are executing out of thy low 
250 locations, you are dead. 

* tho word utility orea must be specified In a place you will not bo oxocutlng 

from during the RAMLOAD program. RAMLOAD always saves any word in RAM Jt 
modifies for utility purposes, and restores It when It Is done, but while Ir. use. 
It con have an arbitrary value. 

A number of things can cause fatal errors during execution. If one happens, an nrror 
message Is written In the system display area, and the program Is aborted. 

I will be happy to help anyone else who needs to program the RAIM. 
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:SYMBOL DEFINITIONS FOR ALTO 

SSTARTF $L1G017.0.0; NDFl-17 

SMOUSE $10.14006.100; 

iOISPSLO.14007,120: 

SMD$L2600G. 14005. 124100; 

$DDR$L26010. 0.124100; 

SXPREG SL26010. 0,124000; 

$CSR 5126011.0,124000; 

$TASK$L16002.0.0; 

$BLOCK$L16003,0.0; 

$HAR$L20001. 0.144000; 

$LLCY8SL0. 22006. 200; 

SLRSHISLO. 22005, 200; 

SLLSHULO. 22004, 200; 

$BUS-0$L24001.0.0; 

$SH<0$L24002.0.0: 

$SH=0$L24003.0.0: 

$BUS$L24004,0.0; 

$ALUCY$L24005.0.0; 

$IDISPSL24015.0,0; 

SBUSODD $L24010.0,0; 

SLHRSHl $10.62005.200; 

SLMLSHl $10.62004.200; 

SEVENFIELDSL24010.0.0; 

$SETMODESL24011.0,0: 

S1R$L26014, 0.124000; 

$ACDESTSl.30013.32013.60100; 

$DNS$L3OO12.0.G0000; 

JACSOURCE$L0.32016.100; 

$L$L40001. 36001. 144200; 

SHALT$L42001.0.0: 

$BREAK$Ln2003.0.0; 

$WENBSL42005.0.0; 

$REAPY?$L42006,0.0; 

$NOVASL44002. 46003, 124100; 

SORTSL0,50002.2: 

SANDTSL0,50003,2; 

$XORT$L0.50004.2; 

$+l$L0.50005,2; 

$-l$L0.50006,2; 

S+TSLO.50007.2; 

S-T$L0.5O010.2; 

$-T-lSL0.50011.2; 

$+lHCT$LO.50012.2; 

$+T+l$L0.50012.2: 

$4SKlP$LO.50013.2: 

ST$L52001. 54001. 124040; 

$END$L34O00.O,0; 

$.T SLO.50014.2; 

SAND NOT T$L0,50015.2; 
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HAGIC RIGHT SHIFT 
MAGIC LEFT SHIFT 



SYNONYM FOR +T+1 



;DEFINITIOHS FOR CONTROL RAM 

SSWHODE $116010.0,0; NOF1«10 

SWRTRAH SLlGOll.0,0; NOFl-11 

SRDRAM $L16012.0.0; NDFl-12 



(EMULATOR) 



:DISK DEFINITIONS 
$KSTAT SL20012. 14003 

SP.WC SL24011, 

SRECNO $L24012. 
SINIT SL24010. 
SCLRSTATSL16014, 
$KC0^1M $L20015. 
$SWRNRDYSL24014, 
SKAPR SL200I5, 
SKDATA SI. "00 17. 
S5TR0BE Sllf.OU. 

i'il«OUONiL24016, 
SVFRDAT Sl.?'?OU. 
$INCR£CN0SL16U13 



1400 
0, 
0. 
0. c 
0, 
.0. 



124100 
0; 
0; 
0; 
0: 

124000; 
0: 
124000; 

12-noO; 



OJ. 



'$S!NK-' $144000, 0, li4000V 
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DF1«12 (LHS) BS-3 (RHS) 

NDF2«ll 

NDF2«=12 

N0F2'=10 

NDF1=14 

DF1=15 (LHS ONLY) REQUIRES BUS OEF 

NDF2»14 

DF1«16 (LHS ONLY) REQUIRES BUS DEF 

Ori«17 (LH5) DS-4 (RHS) 

NDF2«=15 
hOF2-16 
N;)F2-i3 

0F3«0 FARE TO ALLOW BUS SOURCE VITH 



